package com.aisoar.magicsoar.api.service;

import com.aisoar.magicsoar.api.common.base.ApiResult;
import com.aisoar.magicsoar.storage.entity.Playbook;
import com.aisoar.magicsoar.storage.dto.PlaybookDTO;
import com.aisoar.magicsoar.storage.param.PlaybookParam;
import com.aisoar.magicsoar.storage.vo.PlaybookVO;

import java.util.List;

import com.github.pagehelper.PageInfo;

/**
 * 剧本数据表(Playbook)表服务接口
 *
 * @author makejava
 * @since 2025-07-01 13:43:23
 */
public interface PlaybookService {

    /**
     * 通过ID查询单条数据
     *
     * @param param 入参
     * @return 实例对象
     */
    PlaybookVO queryById(PlaybookParam param);

    /**
     * 分页查询
     *
     * @param param 筛选条件
     * @return 查询结果
     */
    PageInfo<PlaybookVO> queryByPage(PlaybookParam param);

    /**
     * 条件查询
     *
     * @param dto 筛选条件
     * @return 查询结果
     */
    List<Playbook> queryAll(PlaybookDTO dto);

    /**
     * 新增数据
     *
     * @param param 入参
     * @return 是否成功
     */
    boolean insert(PlaybookParam param);

    /**
     * 修改数据
     *
     * @param param 入参
     * @return 是否成功
     */
    boolean update(PlaybookParam param);

    /**
     * 通过主键删除数据
     *
     * @param param 入参
     * @return 是否成功
     */
    boolean deleteById(PlaybookParam param);

    ApiResult<String> parseXmlPlayBook(PlaybookParam param);
}
